home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / getpeername.z / getpeername
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttppppeeeeeeeerrrrnnnnaaaammmmeeee((((3333NNNN))))                                                ggggeeeettttppppeeeeeeeerrrrnnnnaaaammmmeeee((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_pppp_eeee_eeee_rrrr_nnnn_aaaa_mmmm_eeee - get name of connected peer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _iiii_nnnn_tttt _gggg_eeee_tttt_pppp_eeee_eeee_rrrr_nnnn_aaaa_mmmm_eeee_((((_iiii_nnnn_tttt _ssss_,,,, _cccc_aaaa_dddd_dddd_rrrr______tttt _nnnn_aaaa_mmmm_eeee_,,,, _iiii_nnnn_tttt _****_nnnn_aaaa_mmmm_eeee_llll_eeee_nnnn_))))_;;;;
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _gggg_eeee_tttt_pppp_eeee_eeee_rrrr_nnnn_aaaa_mmmm_eeee returns the name of the peer connected to socket _s.  The _iiii_nnnn_tttt
  16.      pointed to by the _n_a_m_e_l_e_n parameter should be initialized to indicate the
  17.      amount of space pointed to by _n_a_m_e.  On return it contains the actual
  18.      size of the name returned (in bytes).  The name is truncated if the
  19.      buffer provided is too small.
  20.  
  21. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  22.      _0000 is returned if the call succeeds, _----_1111 if it fails.
  23.  
  24. EEEERRRRRRRROOOORRRRSSSS
  25.      The call succeeds unless:
  26.  
  27.      _EEEE_BBBB_AAAA_DDDD_FFFF               The argument _s is not a valid descriptor.
  28.  
  29.      _EEEE_NNNN_OOOO_TTTT_SSSS_OOOO_CCCC_KKKK            The argument _s is a file, not a socket.
  30.  
  31.      _EEEE_NNNN_OOOO_TTTT_CCCC_OOOO_NNNN_NNNN            The socket is not connected.
  32.  
  33.      _EEEE_NNNN_OOOO_MMMM_EEEE_MMMM              There was insufficient user memory for the operation
  34.                          to complete.
  35.  
  36.      _EEEE_NNNN_OOOO_SSSS_RRRR               There were insufficient STREAMS resources available
  37.                          for the operation to complete.
  38.  
  39. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  40.      _aaaa_cccc_cccc_eeee_pppp_tttt(3N), _bbbb_iiii_nnnn_dddd(3N), _gggg_eeee_tttt_ssss_oooo_cccc_kkkk_nnnn_aaaa_mmmm_eeee(3N), _ssss_oooo_cccc_kkkk_eeee_tttt(3N).
  41.  
  42. NNNNOOOOTTTTEEEESSSS
  43.      The type of address structure passed to _aaaa_cccc_cccc_eeee_pppp_tttt depends on the address
  44.      family.  UNIX domain sockets (address family _AAAA_FFFF______UUUU_NNNN_IIII_XXXX) require a
  45.      _ssss_oooo_cccc_kkkk_eeee_tttt_aaaa_dddd_dddd_rrrr______uuuu_nnnn structure as defined in _ssss_yyyy_ssss_////_uuuu_nnnn_...._hhhh; Internet domain sockets
  46.      (address family _AAAA_FFFF______IIII_NNNN_EEEE_TTTT) require a _ssss_oooo_cccc_kkkk_aaaa_dddd_dddd_rrrr______iiii_nnnn structure as defined in
  47.      _nnnn_eeee_tttt_iiii_nnnn_eeee_tttt_////_iiii_nnnn_...._hhhh.  Other address families may require other structures.  Use
  48.      the structure appropriate to the address family; cast the structure
  49.      address to a generic _cccc_aaaa_dddd_dddd_rrrr______tttt in the call to _gggg_eeee_tttt_pppp_eeee_eeee_rrrr_nnnn_aaaa_mmmm_eeee and pass the size
  50.      of the structure in the _n_a_m_e_l_e_n argument.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.